IRIX Base Documentation 2001 May/SGI IRIX Base Documentation 2001 May.iso/usr/share/catman/p_man/catD/pciio_get.z/pciio_get

Text File | 1998-10-30 | 12.4 KB | 265 lines

ppppcccciiiiiiiioooo____ggggeeeetttt((((DDDD3333))))                                                    ppppcccciiiiiiiioooo____ggggeeeetttt((((DDDD3333))))



NNNNAAAAMMMMEEEE
     pciio_get: pciio_intr_dev_get, pciio_intr_cpu_get, pciio_pio_dev_get,
     pciio_pio_slot_get, pciio_pio_space_get, pciio_pio_pciaddr_get,
     pciio_pio_mapsz_get, pciio_dma_dev_get, pciio_dma_slot_get,
     pciio_info_get, pciio_info_dev_get, pciio_info_bus_get,
     pciio_info_slot_get, pciio_info_function_get, pciio_info_vendor_id_get,
     pciio_info_device_id_get - interrogate PCI infrastructure

SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
     ####iiiinnnncccclllluuuuddddeeee <<<<ssssyyyyssss////PPPPCCCCIIII////ppppcccciiiiiiiioooo....hhhh>>>>

     vvvveeeerrrrtttteeeexxxx____hhhhddddllll____tttt
     ppppcccciiiiiiiioooo____iiiinnnnttttrrrr____ddddeeeevvvv____ggggeeeetttt((((ppppcccciiiiiiiioooo____iiiinnnnttttrrrr____tttt _i_n_t_r))))

     vvvveeeerrrrtttteeeexxxx____hhhhddddllll____tttt
     ppppcccciiiiiiiioooo____iiiinnnnttttrrrr____ccccppppuuuu____ggggeeeetttt((((ppppcccciiiiiiiioooo____iiiinnnnttttrrrr____tttt _i_n_t_r))))

     vvvveeeerrrrtttteeeexxxx____hhhhddddllll____tttt
     ppppcccciiiiiiiioooo____ppppiiiioooo____ddddeeeevvvv____ggggeeeetttt((((ppppcccciiiiiiiioooo____ppppiiiioooommmmaaaapppp____tttt _p_i_o_m_a_p))))

     ppppcccciiiiiiiioooo____ssssllllooootttt____tttt
     ppppcccciiiiiiiioooo____ppppiiiioooo____ssssllllooootttt____ggggeeeetttt((((ppppcccciiiiiiiioooo____ppppiiiioooommmmaaaapppp____tttt _p_i_o_m_a_p))))

     ppppcccciiiiiiiioooo____ssssppppaaaacccceeee____tttt
     ppppcccciiiiiiiioooo____ppppiiiioooo____ssssppppaaaacccceeee____ggggeeeetttt((((ppppcccciiiiiiiioooo____ppppiiiioooommmmaaaapppp____tttt _p_i_o_m_a_p))))

     iiiiooooppppaaaaddddddddrrrr____tttt
     ppppcccciiiiiiiioooo____ppppiiiioooo____ppppcccciiiiaaaaddddddddrrrr____ggggeeeetttt((((ppppcccciiiiiiiioooo____ppppiiiioooommmmaaaapppp____tttt _p_i_o_m_a_p))))

     uuuulllloooonnnngggg
     ppppcccciiiiiiiioooo____ppppiiiioooo____mmmmaaaappppsssszzzz____ggggeeeetttt((((ppppcccciiiiiiiioooo____ppppiiiioooommmmaaaapppp____tttt _p_i_o_m_a_p))))

     vvvveeeerrrrtttteeeexxxx____hhhhddddllll____tttt
     ppppcccciiiiiiiioooo____ddddmmmmaaaa____ddddeeeevvvv____ggggeeeetttt((((ppppcccciiiiiiiioooo____ddddmmmmaaaammmmaaaapppp____tttt _d_m_a_m_a_p))))

     ppppcccciiiiiiiioooo____ssssllllooootttt____tttt
     ppppcccciiiiiiiioooo____ddddmmmmaaaa____ssssllllooootttt____ggggeeeetttt((((ppppcccciiiiiiiioooo____ddddmmmmaaaammmmaaaapppp____tttt _d_m_a_m_a_p))))

     ppppcccciiiiiiiioooo____iiiinnnnffffoooo____tttt
     ppppcccciiiiiiiioooo____iiiinnnnffffoooo____ggggeeeetttt((((vvvveeeerrrrtttteeeexxxx____hhhhddddllll____tttt _v_h_d_l))))

     vvvveeeerrrrtttteeeexxxx____hhhhddddllll____tttt
     ppppcccciiiiiiiioooo____iiiinnnnffffoooo____ddddeeeevvvv____ggggeeeetttt((((ppppcccciiiiiiiioooo____iiiinnnnffffoooo____tttt _i_n_f_o))))

     ppppcccciiiiiiiioooo____bbbbuuuussss____tttt
     ppppcccciiiiiiiioooo____iiiinnnnffffoooo____bbbbuuuussss____ggggeeeetttt((((ppppcccciiiiiiiioooo____iiiinnnnffffoooo____tttt _i_n_f_o))))

     ppppcccciiiiiiiioooo____ssssllllooootttt____tttt
     ppppcccciiiiiiiioooo____iiiinnnnffffoooo____ssssllllooootttt____ggggeeeetttt((((ppppcccciiiiiiiioooo____iiiinnnnffffoooo____tttt _i_n_f_o))))

     ppppcccciiiiiiiioooo____ffffuuuunnnnccccttttiiiioooonnnn____tttt
     ppppcccciiiiiiiioooo____iiiinnnnffffoooo____ffffuuuunnnnccccttttiiiioooonnnn____ggggeeeetttt((((ppppcccciiiiiiiioooo____iiiinnnnffffoooo____tttt _i_n_f_o))))



                                                                        PPPPaaaaggggeeee 1111






ppppcccciiiiiiiioooo____ggggeeeetttt((((DDDD3333))))                                                    ppppcccciiiiiiiioooo____ggggeeeetttt((((DDDD3333))))



     ppppcccciiiiiiiioooo____vvvveeeennnnddddoooorrrr____iiiidddd____tttt
     ppppcccciiiiiiiioooo____iiiinnnnffffoooo____vvvveeeennnnddddoooorrrr____iiiidddd____ggggeeeetttt((((ppppcccciiiiiiiioooo____iiiinnnnffffoooo____tttt _i_n_f_o))))

     ppppcccciiiiiiiioooo____ddddeeeevvvviiiicccceeee____iiiidddd____tttt
     ppppcccciiiiiiiioooo____iiiinnnnffffoooo____ddddeeeevvvviiiicccceeee____iiiidddd____ggggeeeetttt((((ppppcccciiiiiiiioooo____iiiinnnnffffoooo____tttt _i_n_f_o))))

   AAAArrrrgggguuuummmmeeeennnnttttssss
     _i_n_t_r    A PCI interrupt object handle returned by _p_c_i_i_o__i_n_t_r__a_l_l_o_c().

     _p_i_o_m_a_p  A PCI PIO map returned by _p_c_i_i_o__p_i_o_m_a_p__a_l_l_o_c().

     _d_m_a_m_a_p  is a pciio_dmamap_t that was created by _p_c_i_i_o__d_m_a_m_a_p__a_l_l_o_c().

     _v_h_d_l    A pci connection point in the hardware graph, obtained as the
             parameter to the attach call.

     _i_n_f_o    A PCI info object returned by _p_c_i_i_o__i_n_f_o__g_e_t().

DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
     These routines are used to pull specific useful bits of information out
     of the various opaque data structures used by the PCI infrastructure.
     Few drivers will need to make use of these routines, but having them
     available might save the driver from doing extra bookkeeping.

   IIIInnnntttteeeerrrrrrrruuuupppptttt QQQQuuuueeeerrrriiiieeeessss
     Two functions fetch parameters from an interrupt object:

     +o   _p_c_i_i_o__i_n_t_r__d_e_v__g_e_t() returns the connection point of the interrupt
         device.

     +o   _p_c_i_i_o__i_n_t_r__c_p_u__g_e_t() returns the CPU that is the target of interrupts
         for that PCI bus.

   PPPPIIIIOOOO MMMMaaaapppp QQQQuuuueeeerrrriiiieeeessss
     Several functions return items based on a PIO map (see _p_c_i_i_o__p_i_o(D3)):

     +o   _p_c_i_i_o__p_i_o__d_e_v__g_e_t() returns the connection point of the mapped
         device.

     +o   _p_c_i_i_o__p_i_o__m_a_p_s_z__g_e_t() returns the map maximum size.

     +o   _p_c_i_i_o__p_i_o__p_c_i_a_d_d_r__g_e_t() returns the base address specified for the
         map.

     +o   _p_c_i_i_o__p_i_o__s_p_a_c_e__g_e_t() returns the target address space that was
         specified.

     +o   _p_c_i_i_o__p_i_o__s_l_o_t__g_e_t() returns the slot number on the PCI bus for a
         device.






                                                                        PPPPaaaaggggeeee 2222






ppppcccciiiiiiiioooo____ggggeeeetttt((((DDDD3333))))                                                    ppppcccciiiiiiiioooo____ggggeeeetttt((((DDDD3333))))



   DDDDMMMMAAAA MMMMaaaapppp QQQQuuuueeeerrrriiiieeeessss
     Two functions return items based on a DMA as map (see _p_c_i_i_o__d_m_a(D3)):

     +o   _p_c_i_i_o__d_m_a__d_e_v__g_e_t() returns the connection point of the mapped
         device.

     +o   _p_c_i_i_o__d_m_a__s_l_o_t__g_e_t() returns the slot number on the PCI bus for a
         device.

   IIIInnnnffffoooo SSSSttttrrrruuuuccccttttuuuurrrreeee QQQQuuuueeeerrrriiiieeeessss
     The PCI infrastructure stores a version-dependent information structure
     in the connection point for a PCI device.  Several functions are provided
     to retrieve and interrogate this structure.  Those most likely to be
     useful to a device driver are:

     +o   _p_c_i_i_o__i_n_f_o__g_e_t() returns a handle to the information structure.  The
         driver can save this handle at attach time to avoid the small
         overhead of looking it up each time it is needed.

     +o   _p_c_i_i_o__i_n_f_o__d_e_v__g_e_t() returns the vertex handle of the connection
         point (from which the information structure was originally
         retrieved).

     +o   _p_c_i_i_o__i_n_f_o__b_u_s__g_e_t() returns the bus number, always 0 unless the
         system has a PCI to PCI Bridge.

     +o   _p_c_i_i_o__i_n_f_o__s_l_o_t__g_e_t() returns the PCI card slot number of the device.

     +o   _p_c_i_i_o__i_n_f_o__f_u_n_c_t_i_o_n__g_e_t() returns the PCI function number (0 unless
         this device is on a multifunction card).

     +o   _p_c_i_i_o__i_n_f_o__v_e_n_d_o_r__i_d__g_e_t() returns the vendor ID configuration value
         of the device.

     +o   _p_c_i_i_o__i_n_f_o__d_e_v_i_c_e__i_d__g_e_t() returns the device ID configuration value
         of the device.

NNNNOOOOTTTTEEEESSSS
     Bus numbers are arbitrary, not necessarily sequential, and may not be
     unique in large systems; they are only guaranteed to be unique across all
     busses that are connected by PCI-to-PCI Bridges.

SSSSEEEEEEEE AAAALLLLSSSSOOOO
     pciio(D3), pciio_config(D3), pciio_dma(D3), pciio_error(D3),
     pciio_intr(D3), pciio_pio(D3).

DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
     _p_c_i_i_o__i_n_f_o__g_e_t() returns NULL if there is no pciio info structure
     attached to that vertex.






                                                                        PPPPaaaaggggeeee 3333






ppppcccciiiiiiiioooo____ggggeeeetttt((((DDDD3333))))                                                    ppppcccciiiiiiiioooo____ggggeeeetttt((((DDDD3333))))



     Do not pass _i_n_f_o as NULL to any of these functions, that would cause a
     kernel panic.





















































                                                                        PPPPaaaaggggeeee 4444